Файл ReadMe для OpenBuildings™ Designer

Создание пользовательских пакетов

.msi является предпочтительным форматом файла для создания пользовательских пакетов. Файлы .msi легко конфигурируются во время установки, и когда выполняется установка продукта в соответствующей последовательности, файлу .msi не требуются дополнительные параметры для установки в фоновом режиме без вывода информации на экран.

Существует множество сторонних инструментов, с помощью которых можно создавать файлы MSI. Некоторые из них перечислены ниже:
  • WiX (Windows Installer XML)
  • InstallShield
  • Advanced Installer
  • InstallAware
Примечание: Компания Bentley никогда не рекомендует и не поддерживает какие-либо конкретные инструменты разработки для создания пакетов MSI. Представленные здесь примеры приведены только в ознакомительных целях.

Ниже показан пример создания пользовательского пакета с использованием программы установки WiX.

WiX представляет собой бесплатный общедоступный набор инструментов. Сама по себе программа WiX не предоставляет интегрированную среду разработки (IDE), но существует много бесплатных и коммерческих подобных сред, которые могут использоваться с WiX для создания пакетов MSI. Некоторые интегрированные среды разработки перечислены ниже:
  • MSI Factory
  • Microsoft Visual Studio
  • WiXEdit

При создании пакетов MSI может потребоваться идентификация файлов по одной или нескольким категориям:

  1. Программные файлы для OpenBuildings Designer. Это набор файлов, которые должны доставляться в каталог программы OpenBuildings Designer. Путь к местоположению будет выглядеть примерно как C:\Program Files\Bentley\OpenBuildings Designer\. Обычно это файлы конфигурации (.cfg).
  2. Файлы Рабочий набор для OpenBuildings Designer. Это набор файлов, которые должны доставляться в OpenBuildings DesignerКонфигурация. Путь к местоположению будет выглядеть примерно как C:\ProgramData\Bentley\OpenBuildings Designer\. Обычно это файлы дополнительных данных или файлы Рабочий набор.
  3. Различные файлы. Эти файлы могут быть связаны с любым продуктом. Они распространяются вместе с OpenBuildings Designer. Например, это общие библиотеки или файлы, которые могут использоваться другими продуктами.
Файлы той или иной указанной выше категории должны упорядочиваться с соблюдением надлежащей иерархии каталогов. Идентификатором каталога (см. статью Таблица каталогов) для самого верхнего узла каждой категории должно являться публичное свойство пакета MSI, иначе говоря, идентификатор папки должен быть написан прописными буквами. Ниже приведены примеры конфигурирования файлов с использованием идентификаторов каталогов согласно типам этих файлов:
  • Программные файлы (файлы .cfg): MyCompanyPolicy.cfg и MyCompanyWorkSet.cfg. Этот тип файла необходимо доставить в каталог с программой OpenBuildings Designer. Таким образом, поместим этот набор в каталог с идентификатором MYCOMPANY_CONFIGURATIONFILES.
  • Файлы DGN (файлы Рабочий набор): MyWorkSetLibrary.dgn и MyPartnerWorkSetLibrary.dgn. Этот тип файла необходимо доставить в каталог с OpenBuildings DesignerКонфигурация. Таким образом, поместим этот набор в каталог с идентификатором MYCOMPANY_CONFIGURATION.
  • Набор файлов, который может быть доставлен в любое место на компьютере. Таким образом, поместим этот набор в каталог с идентификатором MY_EXTRAFILES.

Подобный способ разделения файлов по месту доставки позволит легко конфигурировать пакет. Нет необходимости иметь все типы файлов в одном пакете. Рекомендуется упаковывать связанные типы файлов в один пакет, что позволяет выполнять установку и обслуживание сразу для всего содержимого такого пакета.

Параметры командной строки

После того, как выбран файл MSI, программа установки OpenBuildings Designer узнает конфигурируемые идентификаторы каталогов. Таким образом, когда пользователь начинает редактировать в окне «Параметры командной строки», ему отображается список возможных идентификаторов.

Ниже приводится пример параметров командной строки:
  • INSTALLFOLDER_CONFIG_FILES и INSTALLFOLDER_WORKSET_FILES. Место, куда будет установлено приложение OpenBuildings Designer, задается во время установки в соответствии с путями стандартных каталогов Windows. Таким образом, программа установки попытается помочь задать путь относительно каталогов OpenBuildings Designer или стандартных каталогов Windows. Для этих параметров командной строки файлы конфигурации могут устанавливаться в папку Config\System, для чего потребуется задать значение [InstallDirectory]\<product_name>\config\system\. Аналогичным образом, файлы Рабочий набор могут устанавливаться в место, где находится Рабочий набор, с использованием пути [ConfigurationDirectory]Configuration\Workspaces\MyCompany\. Доступ к стандартным свойствам, таким как [InstallDirectory] и [ConfigurationDirectory], можно получить через выпадающий список, где указаны возможные соответствующие пути вместе со стандартными каталогами Windows.

Имя параметра командной строки и его значение должны разделяться с помощью символа "=".

Чтобы добавить еще один идентификатор каталога, нажмите<пробел,> а затем введите идентификатор каталога.